2. List of files on this disk, and what goes where.
3. Instructions for upgrading from prior versions.
4. PC Compatibility products.
5. Manual addendum, known conflicts, and other notes.
6. Change history.
7. How to contact Kensington.
WHAT'S NEW:
New Features in version 5.02:
• Made the Application Menu response easier to get to by moving it to the top level of the Response menu.
• Added a feature called Instant Menu, which pops up the application's menu bar at the current cursor position.
• Add help system based on AppleGuide.
• Unfortunately, MouseWorks is no longer system 6.x compatible. The last system 6.x compatible release was version 5.00.
Bug Fixes in version 5.02:
• Kensington software v 4.10 through 5.00 would prevent certain PowerBook models (the 500 series) from sleeping. This has been fixed in version 5.02
• Fixed a problem that could cause Pop-Up menus to contain items named "unnamed button response."
LIST OF FILES ON THIS DISK:
Kensington Installer 5.02 - The installation program that installs Kensington MouseWorks. Double-click this file to install Kensington MouseWorks.
Kensington MouseWorks Read Me - This document containing updates and additions to the information in the User Guide.
WHAT GOES WHERE—EASY INSTALL:
The Easy Install option installs the following files:
Kensington Startup - The Kensington MouseWorks extension that goes in the System Extensions Folder.
ADBReInit - This extension from Apple Computer corrects a problem (possible system freezes when running AppleShare.) on the PowerBook 140/170 and the Quadra 700/900/950. It is only installed if you are running System 7.0.x. This extension is not necessary if you are using System 7.1 or later.
Kensington - This folder is created at the install location. It contains:
- Kensington MouseWorks Read Me - this file.
- Kensington MouseWorks - The program that is used to change mouse options. It is copied into the Kensington folder, and, in System 7 installations, an alias is created in the Control Panels folder.
- Utilities folder - Contains the Simple Text program, which is used to view the readme file.
- Application Sets folder - Contains the sample application sets.
WHAT GOES WHERE—BASICS ONLY:
The Basics Only option installs the following files:
Kensington Basics - A smaller replacement for the normal startup extension for use in machines that start from floppy disks or have very little RAM. Copied to the Control Panels folder.
Kensington - This folder is created at the install location. It contains:
- Kensington MouseWorks Read Me - this file.
- Utilities - A folder containing the following infrequently used items:
- Old Turbo Mouse 1.0 - A control panel program that allows changing the mouse acceleration for users of Kensington Basics.
- Old Turbo Mouse 1.0 Readme - Instructions on how to use Old Turbo Mouse 1.0.
WHAT GOES WHERE—COMPLETE INSTALL:
The Complete Install option installs the following files:
Everything in the Easy Install and Basics Only plus the following:
Kensington - This folder is created at the install location. It contains:
- Utilities - A folder containing the following infrequently used items:
- Convert Preferences - A program that converts Turbo Mouse 4.0x preference files into 5.x compatible Kensington MouseWorks preference files.
- Custom Response - A description of the Custom Response string format in Simple Text format.
- Compatibility Options - A description of the Compatibility Options in Simple Text format.
- Acceleration- A description of the Acceleration Table in Simple Text format.
- Kensington Basics - A smaller replacement for the normal startup extension that is used only in machines that start from floppy disks or have very little RAM.
- Old Turbo Mouse 1.0 - A control panel program that allows changing the mouse acceleration for users of Kensington Basics.
- Old Turbo Mouse 1.0 Readme - Instructions on how to use Old Turbo Mouse 1.0.
- Kensington ADB Test - A test program that can be used by Kensington's technical support department to find out information about your Macintosh.
- ADBReInit Note - Instructions on the use of ADBReInit extension from Apple.
- Teach Text - A program from Apple Computer that is used to view simple documents including this Readme document.
INSTRUCTIONS FOR UPGRADING FROM PRIOR VERSIONS:
You should remove any old copies of Turbo Mouse Startup, Thinking Mouse Startup, or Kensington Mouse Startup prior to installing MouseWorks 5.0 software. (The Kensington MouseWorks Installer will automatically look for any of these files in your Extensions folder and ask you if you want to remove them.)
Users of the Turbo Mouse 4.0x software can use the Convert Preferences program located in the Kensington Utilities folder to convert their old Turbo Mouse Preferences file to a new Kensington Preferences file used in this version of software. The enclosed MouseWorks software will work with Kensington Mouse, Thinking Mouse, and Turbo Mouse. You must do a Complete Install in order for this utility to be installed.
NOTEBOOK KEYPAD OWNERS - Please remove any old copies of Share Modifiers before installing this software. Kensington MouseWorks now incorporates the functionality of Share Modifiers.
PC COMPATIBILITY PRODUCTS:
- MouseWorks 5.0 now provides users of Apple's PC Compatible products with seamless support for two button pointing devices in the PC Environment. If you use Apple's PC Setup 1.5 or higher, MouseWorks will detect that a PC Compatible Card is installed, and configure itself to behave correctly in the PC environment. MouseWorks will create an application set for the PC environment that, by default, contains the following settings.
• The right buttons on multi-button devices are set to send the Right Click signal when you are in the PC environment. You can use the MouseWorks control panel, (the “More Clicks” feature) to modify these types of clicks.
• Acceleration is set to zero. This lets you adjust mouse speed in the PC environment without having problems associated with two acceleration multipliers being engaged. (i.e., You only have one volume knob to adjust.)
• The chord speed is set very fast. This provides better button response in the PC environment.
• All other settings are “inherited” from the current default application set.
Limitations in the PC Environment - MouseWorks is optimized to give basic mouse performance when using the mouse in the PC environment. Some of the advanced features of MouseWorks that are available in the MacOS environment will not work well, or will not work at all in the PC environment.
Features that work well - Click; Drag; Slow Cursor; Axis-only.
Features that may work in the PC environment - Shortcuts may work: this is heavily dependent on the specific shortcut, and which command it implements; Keystrokes: short Keystrokes responses will work OK. (For example Command+Return to toggle environments works well.) Longer keystrokes may give unexpected results.)
Features that do not work in the PC environment - Brilliant Cursor; Pop-Up menus; Snap To Default; Double-Click (the programmed response. Normal double-clicking works without problem).
If You Use An Earlier Version Of PC Setup - We recommend that you upgrade to version 1.5. In the mean time, you can still use MouseWorks for two button support in the PC environment. See below.
If you use SoftWindows, or any other PC Compatible product - You will find a couple of application sets in the Application Sets folder which you can use for your PC compatible environments. To import one of these sets follow the instructions in the manual to import an application set. Use either the SoftWindows set, or the PC Mode set.
MANUAL ADDENDUM, KNOWN CONFLICTS, AND OTHER NOTES:
STARTUP PROBLEMS - If you are having problems be sure you are using the latest versions of any extensions, inits, or control panels you may have in your System Folder. Also, we have seen a few instances where corrupted fonts can prevent certain extensions (including ours) from loading. Reinstalling good copies of the fonts fixes this problem.
BRILLIANT CURSOR - When HotSpots are very, very close together, it may be harder to accurately point to the nearest HotSpot.
QUICKEYS - Users of Quickeys, by CE Software <http://www.cesoft.com> will have problems when attempting to record macros in Quickeys. Mouse clicks from Kensington input devices are not recognized during the recording process. After some discussion with CE Software, we understand that a new version of Quickeys will be available shortly that fixes this problem. Check CE's web site for this free update. Both Kensington and CE apologize for the inconvenience.
In the mean time, you can work around this problem by recording your macros without the Kensington software loaded. They quickest way to do this is to restart your computer, and hold down the "T" key while the machine is booting. This prevents our software from loading. Once you have recorded your macros, you can restart, allow Kensington software to load, and use your macros in the normal manner.
AFTER DARK ONLINE - Users of After Dark Online or other After Dark interactive modules will find that they cannot use Kensington input devices to click on objects in After Dark interactive screen savers. This is due to a problem with the way that the After Dark engine looks for mouse clicks. Berkeley Systems <http://www.berksys.com> tells us that the problem will be fixed in a future version of the After Dark engine.
ADVANCED GRAVIS MOUSESTICK II and/or FIREBIRD -
1. Kensington MouseWorks software now ignores Advanced Gravis <http://www.gravis.com> devices (with ID 23 and 4E) by default. This means that Kensington acceleration controls will not, by default, have any effect on Gravis devices. This results in better performance of the Gravis devices, and will eliminate locks up and other problems related to the Kensington software attempting to manage input from the Gravis devices.
2. Users of both Kensington and Gravis devices may experience problems (lockups, device acceleration problems, and application crashes) when both devices are connected and software from both companies is loaded. In our testing, these problems are eliminated by forcing the Gravis software to load first. Since extensions load in alphabetical order, the Firebird software and Kensington Startup software will not normally have a problem (unless you have taken steps to change the load order.) However, since Control Panels load after extensions, you ARE likely to have problems with the MouseStick II Control Panel. (Latest tested version 3.3.1.) You may be able to solve this problem by using an extension manager, or by moving the Kensington Startup extension OUT of the extensions folder and into the system folder. This will force the Kensington Startup extension to load last. If you experience any problems using your Kensington device this way, put the Kensington Startup extension back into the extensions folder.
EUDORA - You should not attempt to define HotSpots while EUDORA is the frontmost application. Trying to bring up the Brilliant Cursor Hotspot definition window while Eudora is frontmost will in all likelihood crash EUDORA.
ADOBE ILLUSTRATOR - Versions earlier than 5.01 do not work with the Brilliant Cursor HotSpot Definition window . Illustrator version 5.01 or later have been tested and work fine.
ISI MOUSESCREEN ADB - ISI touch screen users cannot use Kensington mouse startup because the ISI device does not correctly follow the ADB specification. Use Kensington Basics or the serial version of the Mousescreen to work around this problem.
MORE DISK SPACE - Alysis users should make sure they have version 1.2 or greater of More Disk Space.
OUTBOUND PORTABLE - When using Plus ROMs it has been reported that after first turning on the machine, you must use the built in pointing device before using an external device. Otherwise the external device may be ignored until a control is operated with the internal device.
QUICK TOOLS POWER STRIP - Interferes with Brilliant Cursor HotSpot definition. You must temporally disable this product before defining HotSpots.
RADIUS PIVOT - You should not rotate the monitor while the Brilliant Cursor HotSpot definition window is on the screen. Radius thinks this problem should be fixed with their software version 2.1+. Using the command key as one of the Cursor Keys while the Radius software is in use may not work as expected and is not recommended.
CHANGING MOUSE BUTTONS ON NON-KENSINGTON INPUT DEVICES - The mouse buttons on non-Kensington input devices are, by factory standard, not modified by MouseWorks. They always send a normal button (Click) and do not work with the Menu Lock feature. You can change this if you want, however.
Caution: If you make this change (as described below), the single button on the non-Kensington mouse is treated the same as the Left Button on the Kensington Mouse. This can cause confusion if you have changed the Left Button to something other than a Click. The non-Kensington input device's button will also be changed. Then, if you disconnect the Kensington Mouse, you may not be able to control the Macintosh. If you find yourself in this state, you can recover in one of two ways:
- Restart your Macintosh with the "T" key pressed down, this causes the Kensington mouse software not to load during startup. You can then delete your preference file and restart.
- Shutdown your Macintosh, plug your Kensington Mouse back in and restart your Macintosh.
If you want to be able to use change the mouse buttons on a non-Kensington device:
1- Determine the type of device by opening the About... window in the Kensington MouseWorks. You will see a list of connected devices.
2- Open the Compatibility Options window. To do this, hold down the Option key on the keyboard, and while holding this key down, choose Compatibility Options from the Options menu.
3- Double-click on the device you identified in the About... window.
4- Deselect the "Do Not Use Enhanced Mouse Buttons" checkbox.
5- Click the OK buttons to close each of the windows you opened.
6- Choose Save Startup from the File menu.
7- Restart your Macintosh.
The first button on the non-Kensington input device will now be treated the same as the Left Button. All button features will now work. If the device has a second button, it may work as a right button. (This depends on the how the manufacture designed the device.) To avoid the problem described above, either:
- Do not redefine the Left Button press, or if you do redefine it, define it with a Button Response capable of doing a normal click, such as a Pop-Up Menu with a Button item, or a Drag.
- Before disconnecting the Kensington Mouse, change the Left Button to Click.
- Go back into the Compatibility dialog and select the "Do Not Use Enhanced Mouse Buttons" option for the input device you are using.
The Kensington Utilities folder (installed to the Kensington folder during a Complete Installation) contains additional information on the Compatibility options in a file called "Compatibility." PowerBook Duo users with two buttons may want to read about the Swap Buttons option that can be used to swap the meaning of the top and bottom buttons of the Duo's built-in trackball.
CONTROL PANEL HIDDEN FEATURES - There are a few obscure features within Kensington MouseWorks that can only be accessed when the option key is held down. They are:
• CUSTOM RESPONSE - Hold down the Option key while clicking on the response menu in the Buttons tab, to show the Custom response item. The syntax for this response is defined in the Custom Response document installed on your system during a COMPLETE Kensington MouseWorks installation.
• COMPATIBILITY OPTIONS - Hold down the Option key while clicking on the Options menu to show the Compatibility Options item. Compatibility Options is documented in the Compatibility Options document installed on your system during a COMPLETE Kensington MouseWorks installation.
• ACCELERATION TABLE - Hold down the Option key while viewing the Acceleration tab (with the Fine Adjustment checkbox selected) to display the Table button. The dialog that comes up in response to this button allows for very fine tweaking of the acceleration curve. The Acceleration Table is documented in the Acceleration document installed on your system during a COMPLETE Kensington MouseWorks installation.
• CONVERT SHORTCUTS - In the Shortcut dialog (displayed when a shortcut response is selected from the Response Menu) the OK button is changed to a Convert button when you hold down the Option key. Clicking Convert will convert the selected shortcut action into its custom parts: it will be displayed as such from then on (i.e. the Cancel shortcut will be displayed as a keystrokes response that sends an Escape character. Note that the label for the response maintains the Shortcut name).
CHANGE HISTORY:
New Features in version 5.02:
• Made the Application Menu response easier to get to by moving it to the top level of the Response menu.
• Added a feature called Instant Menu, which pops up the application's menu bar at the current cursor position.
• Add help system based on AppleGuide.
• Unfortunately, MouseWorks is no longer system 6.x compatible. The last system 6.x compatible release was version 5.00.
Bug Fixes in version 5.02:
• Kensington software v 4.10 through 5.00 would prevent certain PowerBook models (the 500 series) from sleeping. This has been fixed in version 5.02
• Fixed a problem that could cause Pop-Up menus to contain items named "unnamed button response."
Changes in version 5.01:
• This version was never released to the public.
New Features in version 5.00:
• Made major changes to the user interface. We’ve focused on making the software as easy to use as possible.
• Added improved support for Apple's PC Compatibility Card. See below for details on this feature.
• The "Application Menu" feature has been added to the Shortcuts list. This feature will pop up a menu with all of the currently running applications in it. You can then select an item from the menu, and that application will be brought to the front. VERY COOL!
• Added ability to import and export application sets. We’ve included a folder with some pre-defined Application Sets for popular applications. Try ‘em!
• You can now make an application set for the Finder.
• MouseWorks software now uses an installer.
• Modified button presses now inherit responses from the "parent" button. (For example: If you define Right button as double-click, when you hold down the option key and press the right button, the driver sends an Option+Double-click response.) Prior to this release, you had to explicitly program Option+ Right button to behave this way.
Bug Fixes in version 5.00:
• When using brilliant cursor to jump to a hotspot that is off screen (due to a change in the size of the screen resolution) the cursor no longer constantly tries to jump to the off screen hotspot. Essentially we would try to jump to this spot forever, or at least a really long time.
• Fixed problem with button locking down, and staying down, when switching between applications and clicking on the menu bar at the same time.
• When using either Stickies or FileMaker Pro version 2.13 along with the Brilliant Cursor HotSpot Definition dialog (the dialog you bring up using the hotkey) strange things used to happen. System crashes when using Stickies and scary error messages about corrupt files when using FileMaker Pro. This has been corrected.
• When using the "Keystrokes" response on some slower machines long character sequences could have characters get lost. This has been corrected.
Changes in version 4.22:
• Minor aesthetic changes to support new additions to Kensington's input device product line.
Changes in version 4.11:
• Fixed a problem that could cause crashes during boot on some machines running System 6.0.7.
• Fixed a problem that could appear if certain 3rd party video products are installed.
• Fixed a problem that could cause startup problems with Open Transport networking installed.
• Fixed a problem using arrow keys to select items in certain scrolling lists.
